Acción de entrada: Transferencia de archivos Permalink

Con la acción de entrada «File Transfer», se puede transferir un archivo desde una variante operativa (visualización de destino o web) al PLC, así como desde y hacia el PLC. Esto funciona mediante una transferencia de archivos («Type»: «Archivo») o streaming («Tipo»: «Streaming»).

La acción tiene como efecto que se muestre un cuadro de diálogo de selección de archivos en la visualización en tiempo de ejecución. Allí el usuario de visualización puede seleccionar un archivo que será transferido hacia o desde el PLC: Para una transferencia desde un PLC a la visualización, se abre el cuadro de diálogo «Guardar archivo». Para la transferencia de la visualización al PLC, se abre el cuadro de diálogo «Open File».

«Transferencia»

«Dirección»

Dirección de la transferencia de archivos

«Del PLC a la visualización»

El objeto especificado en «Nombre de archivo» o «Nombre de instancia de streaming» se transfiere del PLC a la visualización.

El diálogo de selección de archivo de «Save File» se muestra en la visualización en tiempo de ejecución.

«De la visualización al PLC»

El archivo especificado por el usuario de visualización se transfiere al PLC y se guarda en la ruta de archivo especificada en «Nombre de archivo» o «Nombre de instancia de streaming».

El diálogo de selección de archivos «Open File» se muestra en la visualización en tiempo de ejecución.

«Tipo»

Determina cómo se transfiere el archivo

  • Tipo de transferencia «Archivo»: Por transferencia de archivos

  • Tipo de transferencia «Streaming»: Por streaming

«Tipo»

«Archivo»

La transferencia de datos se realiza por transferencia de archivos.

«Nombre del fichero»

Ruta del archivo (tipo ‎STRING‎) que describe el archivo en el sistema de archivos.

  • Variable

    Por ejemplo: ‎strTransferFile: STRING;‎

  • Literal con ruta relativa

    Ejemplo: ‎'/Recipes/Recipe_1.txt'‎ guarda el archivo en el directorio ‎Recipes‎.

  • Literal con marcador de posición ‎$PLCLOGIC$‎

    ‎PlcLogic‎ es la resolución por defecto para el marcador de posición del directorio ‎$PLCLOGIC$‎.

    Ejemplo: ‎'$$PLCLOGIC$$/test.txt'‎ guarda el archivo en el directorio ‎PlcLogic‎.

    Ejemplo: ‎'$$PLCLOGIC$$/MyData/test.txt'‎ guarda el archivo en el directorio ‎PlcLogic/MyData‎.

  • Literal con marcador de posición ‎$VISU$‎

    ‎visu‎ es la resolución por defecto del marcador de posición ‎$VISU$‎.

    Ejemplo: ‎'$$VISU$$/test.txt'‎ guardar el archivo en el subdirectorio ‎PlcLogic/visu‎. Como alternativa, también se puede especificar ‎'visu/test.txt'‎.

  • Literal con ruta absoluta

    Por ejemplo: ‎'E:\temp\test.txt'‎

    Nota: Este tipo de rutas de archivo no siempre son compatibles.

NOTA:

Si un usuario especifica la ruta del archivo en la visualización mediante un elemento «Text Field», no debe incluirse el carácter de enmascaramiento ‎$‎: ‎$VISU$/dummy.txt‎

NOTA:

En el caso de que la ruta del archivo sea especificada por el usuario, debe ser comprobada por la aplicación para evitar que los archivos sean leídos o sobrescritos accidentalmente.

«Tipo»

«Streaming»

La transferencia de datos se realiza por streaming.

«Nombre de la instancia de streaming»

Ruta de la instancia (tipo ‎IVisuStreamWriter‎ o ‎IVisuStreamReader‎) que describe el objeto en el sistema de archivos del controlador.

Escriba ‎IVisuStreamReader‎ para la dirección de transferencia «Del PLC a la visualización»

Escriba ‎IVisuStreamWriter‎ para la dirección de transferencia «De la visualización al PLC»

«Banderas de control»

Nota: La variable se evalúa sólo para la dirección de transferencia «De la visualización al PLC».

Variable (tipo ‎DWORD‎)

Determina cómo se gestiona el objeto (archivo u objeto de instancia) en el sistema de archivos del PLC. Para ello se proporcionan dos banderas con las que se puede configurar la variable.

  • Bandera 1: ‎VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName‎

  • Bandera 2: ‎VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc‎

Opciones

  • No hay bandera:

    El usuario selecciona un archivo que se guarda en la ruta especificada en «Nombre del archivo» o «Nombre de la instancia de streaming».

  • El indicador 1 está activado:

    La ruta, especificada por el usuario en tiempo de ejecución de la visualización, se aplica y se utiliza como ruta en el sistema de archivos del PLC.

  • Ambas banderas están activadas:

    También se comprueba la ruta. Si ya existe un objeto en la ruta especificada en el lado del cliente, aparecerá un mensaje en la visualización. Allí el usuario de visualización puede confirmar que el archivo se sobrescribirá.

Por ejemplo: ‎dwControlFlag‎

Ejemplo

La dirección de transferencia es «De Visualización a PLC» (escritura).

Por ejemplo: Se ha creado un nuevo archivo de receta ‎Recipes/Recipe_2021.txt‎ en el dispositivo de visualización. El usuario de visualización selecciona este archivo y desea guardarlo en el PLC con el mismo nombre. Como los indicadores de control están ajustados en consecuencia, se abre una ventana de mensaje y el usuario de la visualización puede confirmar que se sobrescribirá el archivo.

PROGRAM PLC_PRG
VAR
    xVisuToggle : BOOL;
    dwControlFlag : DWORD := VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName
                             + VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc;
    strFileName: STRING := '/Recipes/Recipe_new.txt';
END_VAR

«Variables de estado»

«Transferencia activa»

Variable booleana (opcional)

‎TRUE‎: La transferencia está en curso.

«Transferencia exitosa»

Variable booleana (opcional)

‎TRUE‎: La transferencia se ha completado con éxito.

«Código de error»

  • ‎0‎: Sin errores

  • ‎1‎: Error no especificado

  • ‎2‎: Cancelación del diálogo de archivo

  • ‎3‎: Otra transferencia de archivos en curso

  • ‎4‎: Error durante la transferencia de archivos

  • ‎5‎: Anulación por tiempo de espera

  • ‎6‎: Error de lectura de archivo - El archivo no está disponible o no se puede leer.

  • ‎7‎: Sin soporte de dispositivos para la transferencia de archivos

    Posibles causas:

  • CODESYS WebVisu: La transferencia de archivos no es posible por defecto.

  • Comunicación con un controlador de una versión < 3.5.11: Funcionalidad no implementada.

  • Comunicación con un controlador de una versión >= 3.5.11: Transferencia de archivos no activada (descripción del dispositivo).

    TIP:

    CODESYS gestiona esta configuración en los ajustes del proyecto.

«Utilizar archivos de visualización locales»

Requisito: La opción está disponible cuando se ha especificado como dirección «Transferir archivos de visualización al PLC».

  • _cds_icon_option_deactivated.png: Se muestra inmediatamente el cuadro de diálogo de selección de archivos del sistema operativo (por defecto para una acción de entrada creada recientemente).

  • _cds_icon_option_black_activated.png: El cuadro de diálogo de transferencia de archivos, disponible por defecto, se abre y le pide que seleccione un archivo. Puedes adaptar el diálogo.

    Pista: Es posible que el cuadro de diálogo se muestre en un lugar inconveniente y que la disposición del cuadro de diálogo no se corresponda con la de la interfaz de la visualización web.